License Manager - Specific Environment Variables

The LSDEFAULTDIR environment variable can be used to set the default location of the License Manager files.

By default, the default directory is set to the directory the License Manager executable is located in. It’s recommended that the License Manager default directory not be changed.

For example, to tell the License Manager running on a Windows computer that the default directory for License Manager files is a directory named, C:\LS_FILES, use the following command:

SET LSDEFAULTDIR=C:\LS_FILES

The LSERVRC environment variable can be used to set the name and location of the license code file.

By default, this file will be called lservc and reside in the License Manager default directory. It’s recommended that the default name and location are used for this file.

For example, to tell the License Manager that license code file is in the current directory but named, network.lic, set the variable as follows:

SET LSERVRC=NETWORK.LIC

To tell the License Manager running that license code file name and path is, C:\LS_FILES\NETWORK.LIC, set the variable as:

SET LSERVRC=C:\LS_FILES\NETWORK.LIC

The LSERVRCCNF environment variable can be used to set the custom name and location of the License Manager general-purpose configuration file, containing readable license remap statements and alert action statements. If LSERVRCCNF is not used to specify the configuration file, then the name and location of this file will be based upon the name and location of the license code file. Hence, the configuration file will be looked in the same directory as the license code file and have the same base name as the license code file but with the extension .cnf.

• Typically, the License Manager configuration file is called lservrc.cnf and resides in the License Manager default directory. It’s recommended that the default name and location are used for this file.
• To tell the License Manager that configuration file is in the C:\LS_FILES directory and named, network.cnf:

SET LSERVRCCNF=C:\LS_FILES\NETWORK.CNF

• To tell the License Manager that configuration file is in the default directory (which will be the License Manager directory) but named, network.cnf:

• SET LSERVRCCNF=NETWORK.CNF

The LSRESERV environment variable can be used to set the name and location of the License Manager reservation file. This file is used by a system administrator to specify the computers and users are authorized to run a licensed application.  It’s recommended that the default name and location be used for this file. By default, this file will be called lsreserv and reside in the License Manager default directory.

For example, to tell the License Manager running on a Windows computer that the license reservation file is in the current directory but named, reserve, use the following command:

SET LSRESERV=RESERVE

The License Manager port number is used by the UDP protocol when transferring data between the License Manager and the client. Do not change the port number unless your vendor has instructed you to do so or conflicts are occurring between the License Manager and another network application that is using the License Manager’s port number. (The License Manager default port number is 5093, and has been registered to SafeNet, Inc.) A symptom of such a conflict would be License Manager communication errors.

For example, to tell the License Manager running on a Windows computer to use the port number 5093, use the following command:

SET LSPORT=5093

This environment variable can be used to get the name of the error log file.

This environment variable can be used to set the location of LSERVSTA log file. If you want to store this file at some other location, set "LSERVSTA" environment variable with a valid path.

This environment variable can be used to set the name and location of the upgrade file. This file contains the upgrade license string. By default, RMS server searches for this file at the current server location.

The LS_LOG_ANONYMITY environment variable can be used to enable or disable the anonymous usage logging in the License Manager usage log files. You can set its value as 1 or 0 to enable or disable the anonymous logging, respectively.

By default, the License Manager uses real user name and host name in the usage log.

For example, to enable anonymous usage logging, use the following command:

SET LS_LOG_ANONYMITY=1

See also, Details about the Anonymous Usage Logging Option.